Unspecified parameters should be replaced with "*". MacHTTP tries to match
a file suffix first. Failing that, it tries to match Mac file type info, and if it
can, Mac creator info as well. Matching either suffix or type/creator determines
the transfer type and MIME type. If the client supports HTTP/1.0, the appropriate
MIME header will be constructed and returned, based on the info below.
Scripts are responsible for generating their own HTTP/1.0 headers!!!
The following lines specify where to find HTML files for error messages, the
default home (or index) page, the name of the log file, and the message
returned for security violations.
ERROR :Error.html
INDEX :Default.html
LOG :MacHTTP.log
NOACCESS :NoAccess.html
TIMEOUT
Sets the timeout for inactive connections to 60 seconds
TIMEOUT 60
MAXUSERS
Sets the max number of simultaneous users to 8.
The minimum value is 3, the maximum is 1000 (!!!)
For larger values, you should monitor memory usage and increase
MacHTTP's memory allocation in the Finder accordingly.
MAXUSERS 8
Sets the number of "listens" MacHTTP performs simultaneously. For
busy servers with clients that report "Unable to connect" errors,
this number should be increased. If the "Listening" statistic in
the status window ever drops to 1, some clients may miss connecting.
Default is 5, minimum is 3, maximum is 50.
MAXLISTENS 3
A single copy of MacHTTP only listens on a single port for multiple
connections. The HTTP standard port is 80. Users may define any port
they'd like to listen on, but internet standards say that ports
numbered 1024 and below are reserved for "Well known services" that
are pre-defined. That means if you change MacHTTP's port from 80,
you should pick a number greater than 1024 to avoid conflicting with
things like telnet, gopher, ftp, nfs, pop, etc. that all have ports
assigned below 1024.
PORT 80
Security
Configure access permissions. There is an implied "DENY *" that is evaluated
prior to any user security specifications if present. Otherwise, the default is
"ALLOW *". End complete host IP addresses with a "." for an exact match. Otherwise
a statement like "ALLOW 129.106.3" would match hosts 129.106.30.*, 129.106.31.*,
129.106.32.*, etc.
NOTE!!! "ALLOW *" and "DENY *" are not valid syntax!
ALLOW 129.106.3.
DENY 129.106.3.1.
If the following line is uncommented, MacHTTP will hide the status window when
it is in the background.
HIDEWINDOW
>Hey Chuck...I am running our server on a 6100/60AV...what would you recommend
>for # of users? pig delay? dump buf size?
The defaults out of the box are probably fine. The dump_buf_size may be
adjusted downwards if you are seeing bad performance over slow network
connections (or lots of timeouts.) You should always keep max_users about
20% over whatever the highest number of simultaneous users ever recorded
has been. pig_delay should be adjusted downwards if you are using the Mac
for other uses (and MacHTTP is being a pig.)
This is the number of ticks that MacHTTP will "steal" from other processes while
sending data to clients. This equates directly to how much time MacHTTP will spend
processing connections. Your Mac will effectively be dedicated to MacHTTP for this
period of time. The argument is in "ticks", which are 60ths of a second. The default
is .5 seconds. (30 ticks) Values can range between 0 and 120.
PIG_DELAY 30
This is the chunk size that MacHTTP will divide file transfers into. The larger the
chunk, the longer it will take to transmit over slow connections. The smaller it is, the
more times MacHTTP will be able to swap between servicing multiple connections and
freeing the Mac to work on other processes. The argument represents the max number of
bytes to be sent in a single MacTCP write to the client. The min is 256, the max is 10240.
DUMP_BUF_SIZE 10240
7/6/94 - gneufeld
MacHTTP Contents